feat: list owned animals with their last coordinates - #43

Summary

• Adds /animals (alias /livestock) so a player can see every animal they own or co-own, with the last block each one was seen at.
• Stores that location when the animal loads, on the minute tick, on unload, and on shutdown, and prints a chat roster with status and click-to-copy coordinates.
• Staff with cooking.admin can run /animals <player> for someone who has joined.

Documentation impact

• Central Cooking documentation: updated in TF-Minecraft/Docs docs/list-owned-animals
• Player wiki (ProvinceSystem /wiki/animal-husbandry): updated in TF-Minecraft/ProvinceSystem feat/animals-list-wiki

Contract

• Affected behavior: new player command and husbandry schema migration user_version 7 → 8 (world, x, y, z). Existing rows keep their data and show no coordinates until the animal loads once.
• Tests run (mvn test): 199 tests, 0 failures. Includes roster formatting and a version-7 database migration.
• Player wiki: updated

Test plan

• /animals with no animals explains how to claim one
• Owned and co-owned animals list name, species, status, and coordinates
• Clicking coordinates copies world x, y, z
• An animal that has not loaded yet says the location is not recorded
• A player cannot list someone else's animals; staff and the console can
• Restart keeps coordinates for an animal that was loaded before shutdown

Made with Cursor

Summary by CodeRabbit

• New Features
  • Added the /animals command, with /livestock as an alias, to view your animal roster and where each animal was last seen.
  • Administrators can look up another player’s roster. Listings include animal details, ownership roles, status, and coordinates that can be clicked to copy.
  • Animal locations are saved and remain available when animals are not currently loaded.